home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / find218.zip / FIND.DOC next >
Text File  |  1991-01-27  |  46KB  |  1,651 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.          Online Reference Software
  8.           
  9.           
  10.          Assembly language software products
  11.          providing maximum performance in a
  12.          minimum amount of space.
  13.           
  14.           
  15.          FIND - fastest file and zip search for DOS
  16.           
  17.           
  18.           
  19.           
  20.           
  21.           
  22.           
  23.           
  24.           
  25.           
  26.           
  27.                         Users Manual - January 28, 1991
  28.           
  29.           
  30.           
  31.           
  32.           
  33.           
  34.           
  35.           
  36.           
  37.           
  38.           
  39.           
  40.           
  41.           
  42.           
  43.           
  44.           
  45.           
  46.           
  47.           
  48.           
  49.           
  50.           
  51.           
  52.           
  53.           
  54.           
  55.           
  56.           
  57.           
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                     Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                LICENSE STATEMENT
  74.           
  75.           
  76.           
  77.          Online Reference hereby grants you, the user, a non-exclusive
  78.          license to use FIND in its delivered form.
  79.           
  80.          You may use the registered version of the software on any
  81.          computer, provided that the software can in no way be used on
  82.          more than one computer at the same time.
  83.           
  84.          You are encouraged to freely copy and distribute the share
  85.          ware version of the software as long as it is not modified or
  86.          missing any of the component files.
  87.           
  88.           
  89.           
  90.           
  91.           
  92.                                    WARRANTY
  93.           
  94.           
  95.           
  96.          Online Reference warrants software delivered by diskette
  97.          to be an accurate copy of the master diskette.  Defective
  98.          diskettes will be replaced free of charge within 60 days
  99.          after purchase.
  100.           
  101.          Online Reference explicitly disclaims all other warranties
  102.          whether expressed or implied, including, without limitation,
  103.          the implied warranties of merchantability and fitness for any
  104.          particular purpose.  Online Reference shall have no liability
  105.          for consequential, incidental, exemplary or special damages,
  106.          including lost profits.
  107.           
  108.          Online Reference reserves the right to improve or change
  109.          the product at any time without prior notice.
  110.           
  111.           
  112.           
  113.           
  114.           
  115.                                TECHNICAL SUPPORT
  116.           
  117.           
  118.           
  119.          Completing the registration form and paying the published
  120.          fees for the software, qualifies the owner for technical
  121.          support.
  122.           
  123.           
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          CONTENTS
  140.           
  141.           
  142.          INTRODUCTION.............................................. 5
  143.              Overview.............................................. 5
  144.              File contents......................................... 5
  145.              Enhancements.......................................... 5
  146.           
  147.           
  148.          FEATURES OVERVIEW......................................... 6
  149.              Standard Features summary............................. 6
  150.              Advanced Features summary............................. 6
  151.           
  152.           
  153.          FINDINST.................................................. 7
  154.              Overview.............................................. 7
  155.              Colors................................................ 8
  156.              Drive Search Range.................................... 9
  157.              Command Line Switches.................................10
  158.              CGA Snow Checking.....................................10
  159.           
  160.          STANDARD FEATURES
  161.              Performance...........................................11
  162.              DOS Wildcards.........................................12
  163.              Elapsed Time..........................................12
  164.              DOS Directory Format..................................13
  165.              Intelligent I/O.......................................13
  166.              Long Screen Support...................................13
  167.              Dynamic Memory Allocation.............................14
  168.              EMS Memory............................................14
  169.              Extended Disk Partitions..............................15
  170.              Multi-Drive Search....................................15
  171.              SNAPSHOT Disk Dump....................................15
  172.           
  173.           
  174.          ADVANCED FEATURES
  175.              Fuzzy Search..........................................16
  176.              Command Line Switches.................................17
  177.                  /G - Goto first match.............................17
  178.                  /H - Hidden Search................................17
  179.                  /L - List Buffer..................................17
  180.                  /P - Pause Full Screen............................18
  181.                  /S - Single Drive.................................18
  182.                  /V - Verbose Path.................................18
  183.                  /Z - ZIP Search...................................18
  184.           
  185.           
  186.           
  187.           
  188.           
  189.           
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                     Page 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.          CONTENTS
  206.           
  207.           
  208.          IMPLEMENTATION
  209.              Technical Data........................................19
  210.              PIF...................................................20
  211.              DOS Error Level.......................................20
  212.              CGA Snow Checking.....................................20
  213.              Error Messages........................................21
  214.              Switch Summary........................................22
  215.              Command Line Examples.................................23
  216.           
  217.           
  218.          SUPPORT
  219.              Bug Reports...........................................25
  220.              BBS System............................................25
  221.           
  222.           
  223.           
  224.           
  225.           
  226.           
  227.           
  228.           
  229.           
  230.           
  231.           
  232.           
  233.           
  234.           
  235.           
  236.           
  237.           
  238.           
  239.           
  240.           
  241.           
  242.           
  243.           
  244.           
  245.           
  246.           
  247.           
  248.           
  249.           
  250.           
  251.           
  252.           
  253.           
  254.           
  255.           
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                     Page 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          INTRODUCTION
  272.           
  273.           
  274.          FIND is an ultra high speed file finding program.
  275.           
  276.          It searches the disk drive(s) for the specified files using
  277.          the standard DOS drive, filename and wildcard structure.
  278.          The current version will optionally search ZIP (tm) files.
  279.           
  280.          The current version FIND does not support network drives.
  281.           
  282.           
  283.           
  284.          The unregistered version contains the following files:
  285.           
  286.              o   FIND.DOC     - This file
  287.              o   FIND.EXE     - Uses intelligent output display
  288.              o   FIND.HST     - History file FIND versions
  289.              o   FIND.HDR     - CompuServe file description header
  290.              o   FIND.KEY     - CompuServe file description keywords
  291.              o   FINDINST.EXE - Installation and customization program
  292.              o   SNAPSHOT.EXE - Capture disk sectors for bug reports
  293.              o   ORDER.FRM    - Ordering and registration form
  294.           
  295.           
  296.           
  297.              FIND is not public domain or free software.
  298.              The unregistered version is a full speed, complete file
  299.              finder.  Its capacity and performance have not been
  300.              degraded in any way.
  301.           
  302.           
  303.           
  304.          Enhancements:
  305.           
  306.              o  ZIP file search
  307.              o  Fuzzy name search
  308.              o  Installation program
  309.              o  Speed
  310.              o  Color
  311.              o  Single or Multiple drive search
  312.              o  Elapsed time
  313.              o  Exclusive hidden file search
  314.              o  Standard DOS display format
  315.              o  Intelligent output display
  316.              o  Support 80x43 and 132x43 screen sizes
  317.              o  EMS memory used when available
  318.              o  DOS 4 extended disk partition support
  319.              o  Dynamic data segment allocation
  320.              o  Debugging aid
  321.           
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                     Page 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          FEATURES
  338.           
  339.           
  340.          Standard features:
  341.           
  342.              o  Install program
  343.              o  Speed
  344.              o  Automatic search of multiple drives
  345.              o  Automatic wildcard names
  346.              o  Colors
  347.              o  Elapsed Time
  348.              o  Display uses DOS directory format
  349.              o  Intelligent I/O
  350.              o  Long screen support
  351.              o  Dynamic memory allocation
  352.              o  EMS memory support
  353.              o  Extended disk partitions
  354.              o  SNAPSHOT debugging aid
  355.           
  356.           
  357.           
  358.          Advanced features:
  359.           
  360.              o  Fuzzy search for embedded name characters
  361.              o  Search single drive only
  362.              o  Hidden-only file search
  363.              o  Pause when screen is full
  364.              o  Verbose path display
  365.              o  Goto first match
  366.              o  Scroll buffer
  367.              o  CGA snow check control
  368.              o  ZIP file search
  369.           
  370.           
  371.           
  372.           
  373.           
  374.           
  375.           
  376.           
  377.           
  378.           
  379.           
  380.           
  381.           
  382.           
  383.           
  384.           
  385.           
  386.           
  387.           
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                     Page 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.          INSTALLATION
  404.           
  405.           
  406.          --------
  407.          OVERVIEW
  408.          --------
  409.          FIND incorporates an installation program named FINDINST that
  410.          will customize FIND for user-specified colors and options.
  411.           
  412.          FINDINST is version sensitive, and will complain if the
  413.          version is incorrect.  Unregistered and Registered versions
  414.          of the software are unique and cannot be mixed.
  415.           
  416.          The installation program expects to locate FIND.EXE
  417.          in the default directory.  The file name must be unchanged
  418.          from the distribution disk to install properly.
  419.           
  420.          Once installed, FIND may be freely renamed.
  421.           
  422.           
  423.           
  424.           
  425.           
  426.           
  427.           
  428.           
  429.           
  430.           
  431.           
  432.           
  433.           
  434.           
  435.           
  436.           
  437.           
  438.           
  439.           
  440.           
  441.           
  442.           
  443.           
  444.           
  445.           
  446.           
  447.           
  448.           
  449.           
  450.           
  451.           
  452.           
  453.           
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                     Page 7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.          INSTALLATION
  470.           
  471.           
  472.          ------
  473.          COLORS
  474.          ------
  475.          The user may configure the text and inverse video colors used
  476.          by FIND during operation.  The banner colors are fixed and
  477.          cannot be changed.  The default value is to accept whatever
  478.          colors are found at the cursor location when FIND loads.
  479.           
  480.          Invoke FINDINST and choose the Customize Colors option from
  481.          the main menu.
  482.           
  483.          The Normal Text and Inverse Video data are displayed
  484.          in the colors currently installed in FIND.
  485.           
  486.          The un-installed version FIND defaults to whatever colors are
  487.          present at the cursor when the program is invoked.
  488.          FINDINST provides an option on the Colors Menu to restore
  489.          the defaults.
  490.           
  491.          FINDINST displays the default colors in black and white until
  492.          they are changed.  The demo strings are displayed in the new
  493.          color after each selection.  The colors are not installed in
  494.          FIND until the user exits FINDINST.
  495.           
  496.          The user is prompted to enter the hexadecimal values for
  497.          the text or inverse video option.  The number is always
  498.          entered as a 2 digit number.  Results are unpredictable
  499.          if a single digit is entered.
  500.           
  501.          The left number is the Background color.
  502.          The right number is the Foreground color.
  503.           
  504.          07 = White text on black
  505.          17 = White text on blue
  506.          70 = Black text on white (inverse)
  507.           
  508.          The user may enter any value up to FF, if the blink is
  509.          desired.  The color banners are fixed colors, and may not
  510.          be changed by the user.
  511.           
  512.          TEXT colors are for the file name matches displayed when FIND
  513.          executes.  A file that matches the input argument will be
  514.          displayed as a TEXT color, even if it is a ZIP file.
  515.           
  516.          INVERSE colors are for the subdirectory names and/or ZIP file
  517.          names that are displayed.  A ZIP file holding a member file
  518.          that matches the input argument is displayed in INVERSE
  519.          color.  The member will be displayed in TEXT color.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                     Page 8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.          INSTALLATION
  536.           
  537.           
  538.          -----------
  539.          DRIVE RANGE
  540.          -----------
  541.          The user may configure FIND to stop searching after a
  542.          specified drive letter.  This is useful to those who have a
  543.          network drive and don't wish to search all logical drives.
  544.           
  545.          Floppy drives that have been ASSIGNED to a higher letter may
  546.          also be bypassed using this configuration option.  The
  547.          default is for drive 'Z'.
  548.           
  549.          Invoke FINDINST and choose the Drive Search Range option
  550.          from the main menu.
  551.           
  552.          The current highest drive will display as a drive letter.
  553.          The default value in FIND is 'Z'.   The default value for
  554.          the starting drive is the first hard drive.
  555.           
  556.          FIND begins its search with the first hard drive, unless
  557.          the command line file name contains a drive letter or the
  558.          first starting drive is set with FINDINST.
  559.           
  560.          In both versions, the search will automatically increment the
  561.          drive number until no more drives are left to search.  Any
  562.          drive that appears as a valid DOS disk will be searched.
  563.           
  564.          If the user has ASSIGNED a floppy drive as a different drive
  565.          with a letter higher than the last hard disk, it too will be
  566.          searched.  FIND will pause for a moment if the floppy is
  567.          empty, and then quit.  Installing the highest search drive
  568.          option will stop FIND from searching assigned drives.
  569.           
  570.          Another use is on a very large network drive, that goes
  571.          from C to W or even higher.  In spite of FIND's tremendous
  572.          speed, it will still slow down on a very large drive,
  573.          particularly so, if that drive contains many ZIP files.
  574.          The user can limit the search range by using the
  575.          Highest Search option.
  576.           
  577.           
  578.           
  579.           
  580.           
  581.           
  582.           
  583.           
  584.           
  585.           
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                     Page 9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.          INSTALLATION
  602.           
  603.           
  604.          --------
  605.          SWITCHES
  606.          --------
  607.          The user may configure FIND for any of the command line
  608.          switches.  These switches are actually toggles, and may
  609.          be overridden on the command line.
  610.           
  611.          If the /Z switch is set by FINDINST, using it on the command
  612.          line will toggle it to OFF for a one-time run of FIND.
  613.           
  614.           
  615.           
  616.          -----------------
  617.          CGA SNOW CHECKING
  618.          -----------------
  619.          FINDINST is invoked without a command line name.  An optional
  620.          command line argument [/OFF] will bypass CGA snow checking
  621.          for machines that have problems with it, or don't need it.
  622.           
  623.          e.g.  FINDINST /OFF
  624.           
  625.          This switch will force FINDINST to run with snow checking
  626.          disabled.  The user may install this option into FIND by
  627.          selecting the SWITCHES entry on the first menu.
  628.           
  629.           
  630.           
  631.           
  632.           
  633.           
  634.           
  635.           
  636.           
  637.           
  638.           
  639.           
  640.           
  641.           
  642.           
  643.           
  644.           
  645.           
  646.           
  647.           
  648.           
  649.           
  650.           
  651.           
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                     Page 10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.          STANDARD FEATURES
  668.           
  669.           
  670.          -----------
  671.          PERFORMANCE
  672.          -----------
  673.          FIND is significantly faster than other file finders.
  674.           
  675.                            M:SS = Minutes : Seconds
  676.                            S.HH = Seconds . Hundredths
  677.           
  678.                   681 - normal files  │    700 - normal files
  679.                   287 - zip files     │    491 - zip files
  680.                 13860 - zip members   │   4886 - zip members
  681.                                       │
  682.                     16 Mhz 80286      │      4.77 Mhz 8088
  683.                       32mb C:         │         82mb C:
  684.                       DOS 3.30        │         DOS 4.01
  685.           
  686.                    ┌──────┬──────┬─────────┬──────┬──────┐
  687.          ZIP       │  :12 │ 658% │  FIND   │  :39 │ 851% │
  688.          Search    ├──────┼──────┼─────────┼──────┼──────┤
  689.                    │ 1:14 │ 107% │ QF360(4)│ 8:00 │  69% │
  690.                    ├──────┼──────┼─────────┼──────┼──────┤
  691.                    │ 1:19 │ 100% │ PKZFIND │ 5:32 │ 100% │
  692.                    ├──────┼──────┼─────────┼──────┼──────┤
  693.                    │ (1)  │      │  FFF    │ 4:56 │ 112% │
  694.                    ├──────┼──────┼─────────┼──────┼──────┤
  695.                    │ 2:00 │  65% │ WHEREIS │ 5:33 │ 100% │
  696.                    └──────┴──────┴─────────┴──────┴──────┘
  697.           
  698.                    (1) Crashed after 10 seconds.  Reboot required.
  699.                    (2) Finds nothing under DOS 4.
  700.                    (3) Locked up and crashed under DOS 4.01
  701.                    (4) Empty zip files reported as corrupted.
  702.           
  703.                    ┌──────┬──────┬─────────┬──────┬──────┐
  704.          Normal    │  .99 │ 433% │  FIND   │ 1.07 │ 611% │
  705.          Search    ├──────┼──────┼─────────┼──────┼──────┤
  706.                    │ 1.70 │ 252% │  WHIZ   │  (3) │      │
  707.                    ├──────┼──────┼─────────┼──────┼──────┤
  708.                    │ 3.90 │ 110% │   FF    │14.06 │  47% │
  709.                    ├──────┼──────┼─────────┼──────┼──────┤
  710.                    │ 4.29 │ 100% │ WHEREIS │ 6.54 │ 100% │
  711.                    ├──────┼──────┼─────────┼──────┼──────┤
  712.                    │ 5.88 │  73% │  QF360  │40.04 │  16% │
  713.                    ├──────┼──────┼─────────┼──────┼──────┤
  714.                    │ (1)  │      │  FFF    │11.21 │  58% │
  715.                    ├──────┼──────┼─────────┼──────┼──────┤
  716.                    │  .94 │ 456% │  TF77   │ (2)  │      │
  717.                    └──────┴──────┴─────────┴──────┴──────┘
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                     Page 11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.          STANDARD FEATURES
  734.           
  735.           
  736.          -----------------------
  737.          DOS Automatic Wildcards
  738.          -----------------------
  739.          FIND uses the DOS wildcard system for command line arguments.
  740.           
  741.          FILENAME.      = FILENAME.
  742.          FILENAME       = FILENAME.???
  743.          FILE           = FILE????.???
  744.          FILE.          = FILE    .???
  745.          .EXE           = ????????.EXE
  746.           
  747.          *123.*45       = ????????.???
  748.          .              = ????????.
  749.          .*             = ????????.???
  750.          *.*            = ????????.???
  751.          *              = ????????.???
  752.           
  753.          *.             = ????????.
  754.          *.X*           = ????????.X??
  755.           
  756.           
  757.           
  758.          ------------
  759.          Elapsed Time
  760.          ------------
  761.          FIND displays the total amount of time required to search
  762.          all drive(s).
  763.           
  764.          Totals are displayed for number of files matching the input
  765.          argument, total number of files, and number of directories.
  766.           
  767.           
  768.           
  769.           
  770.           
  771.           
  772.           
  773.           
  774.           
  775.           
  776.           
  777.           
  778.           
  779.           
  780.           
  781.           
  782.           
  783.           
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                     Page 12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.          STANDARD FEATURES
  800.           
  801.           
  802.          --------------------
  803.          DOS Directory Format
  804.          --------------------
  805.          FIND displays all file data in the DOS directory format.
  806.          All file data exactly matches the DOS location and format
  807.          conventions.
  808.           
  809.          The file attributes are appended to the standard DOS display
  810.          as both a hex number and their associated name(s).
  811.           
  812.           
  813.           
  814.          --------------------------
  815.          Intelligent output display
  816.          --------------------------
  817.          FIND determines if DOS I/O redirection to a disk file or
  818.          printer is active.
  819.           
  820.          When redirection is active, all output is displayed a second
  821.          time using DOS.  All screen output except the author banners
  822.          are then output to the redirected device or file.
  823.           
  824.          For the screen, the color attribute found at the starting
  825.          cursor location is used.
  826.           
  827.          FIND automatically uses whichever video page number is active
  828.          at startup.  The user video configuration remains unchanged.
  829.           
  830.           
  831.           
  832.          -------------------
  833.          Long screen support
  834.          -------------------
  835.          FIND uses the screen mode that is active at startup.
  836.          The 80x43 and 132x43 text screens are supported.
  837.          40 column mode is not supported.
  838.           
  839.           
  840.           
  841.           
  842.           
  843.           
  844.           
  845.           
  846.           
  847.           
  848.           
  849.           
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                     Page 13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.          STANDARD FEATURES
  866.           
  867.           
  868.          -------------------------
  869.          Dynamic Memory Allocation
  870.          -------------------------
  871.          Internal data segment sizes are allocated on the fly for each
  872.          logical drive that is searched.  Memory is allocated in the
  873.          exact amount required for each drive.
  874.           
  875.          Assume no EMS memory, extended disk partitions and options
  876.          enabled for a worst-case memory map:
  877.           
  878.                           ■   13k code and stack space
  879.                           ■  128k FAT table
  880.                           ■   64k path table
  881.                           ■   64k scroll buffer
  882.                           ■   64k minimum directory data
  883.                           ■   16k floating zip segment
  884.                               -------------------------
  885.                               349k memory requirements
  886.           
  887.           
  888.           
  889.          ------------------
  890.          EMS memory support
  891.          ------------------
  892.          FIND will utilize up to 8 pages of EMS memory for the path
  893.          table and scroll buffer.  This increases the directory data
  894.          space by 128k, and reduces a potential out-of-memory error
  895.          when searching large subdirectories.
  896.           
  897.          FIND identifies the EMMXXXX0 device drive signature then
  898.          allocates EMS memory via DOS interrupt 67h with LIM 3.2
  899.          or higher.  The current context mapping is saved at entry
  900.          and is then restored when FIND terminates.
  901.           
  902.          FIND currently supports 512 directories, and an unlimited
  903.          amount of files.
  904.           
  905.          FIND can execute as a child process of a parent that uses
  906.          EMS memory without interfering with the parents' data.
  907.           
  908.           
  909.           
  910.           
  911.           
  912.           
  913.           
  914.           
  915.           
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                     Page 14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.          STANDARD FEATURES
  932.           
  933.           
  934.          -------------------------------
  935.          Extended disk partition support
  936.          -------------------------------
  937.          FIND supports DOS disk partitions greater than 32mb.
  938.           
  939.          Note that FIND will not work on some non-DOS partitions.  A
  940.          valid DOS boot sector is required on each drive that is
  941.          searched.
  942.           
  943.          Use the DOS FDISK command to DISPLAY the partiton table
  944.          information when a non-DOS partition is suspected.
  945.           
  946.           
  947.           
  948.          ---------------------
  949.          Multiple Drive Search
  950.          ---------------------
  951.          FIND will search multiple drives in ascending order starting
  952.          with the drive specified by the user.  If none is specified
  953.          then the first hard disk is assumed.
  954.           
  955.          Note that systems without a hard drive or ram disk must
  956.          ALWAYS specify the drive letter.  FIND defaults to the first
  957.          drive after the last installed floppy disk.
  958.           
  959.           
  960.           
  961.          ------------------
  962.          SNAPSHOT Disk Dump
  963.          ------------------
  964.          SNAPSHOT.EXE is a debug aid that captures the first 317k of
  965.          data on the specified disk.  The captured data is then
  966.          written to a floppy disk in drive A: as SNAPSHOT.DAT.
  967.           
  968.          When I receive this disk and data, I can reassemble FIND in
  969.          debugging mode and run on the image of your disk.
  970.           
  971.          Caveats:  ALL user data within the 1st 317k of the disk will
  972.          be captured.  When I receive the SNAPSHOT dump, the user
  973.          agrees to release me from all liability associated with his
  974.          data.
  975.           
  976.           
  977.           
  978.           
  979.           
  980.           
  981.           
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                     Page 15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.          ADVANCED FEATURES
  998.           
  999.           
  1000.          ------------
  1001.          Fuzzy Search
  1002.          -------------
  1003.          FIND will support the following command line arguments for
  1004.          embedded characters.
  1005.           
  1006.          Bracketing a string of characters with '*' tells the
  1007.          parser to match that sequence of characters anywhere in
  1008.          the file name and/or extension.
  1009.           
  1010.          Rules:
  1011.          (1)  A fuzzy search field must begin with the asterisk (*)
  1012.               in the first position of the name or file extension.
  1013.           
  1014.          (2)  At least one valid DOS character must be between the two
  1015.               asterisk brackets.  The '?' wildcard is valid.
  1016.               Two consecutive asterisk will return an error.
  1017.           
  1018.          (3)  The fuzzy character count can be no more than 8 for the
  1019.               name field, or 3 for the extension field.
  1020.               This count does not include the brackets (*).
  1021.               An overlength name or extension returns an error.
  1022.           
  1023.          A full length field of fuzzy bytes will be interpreted as
  1024.          a non-fuzzy search, and no error will be returned.
  1025.           
  1026.           
  1027.          IB*AB*         = IB??????    .???
  1028.          *IB*.COM       = <<IB>>      .COM
  1029.          *IB*           = <<IB>>      .???
  1030.          *IB*.i*        = <<IB>>      .i??
  1031.          *IB*.*i*       = <<IB>>      . <<i>>
  1032.          *I?M*.COM      = <<I?M>>     .COM
  1033.          *1234567*.*12* = <<1234567>> . <<12>>
  1034.           
  1035.          *12345678*     = 12345678    .???        ; Legal but useless
  1036.          LOTUS.*123*    = LOTUS       .123        ; Legal but useless
  1037.           
  1038.          *123456789*    = ERROR       ; Overlength name
  1039.          **.Exe         = ERROR       ; Double splats together
  1040.          LOTUS.*1234*   = ERROR       ; Overlength extent
  1041.          *A*B*C.EXE     = ERROR       ; More than 2 '*' wildcards
  1042.           
  1043.           
  1044.           
  1045.           
  1046.           
  1047.           
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                     Page 16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.          COMMAND LINE SWITCHES
  1064.           
  1065.           
  1066.          Switches are available in the Registered version only.
  1067.           
  1068.          Invoke FINDINST and choose the Command Line Switches option.
  1069.           
  1070.          All the currently supported command line switch states will
  1071.          be displayed.  The user is provided with a menu to
  1072.          individually set a switch, or to clear all switches.
  1073.           
  1074.           
  1075.           
  1076.          ---------------------
  1077.          /G - Goto First Match
  1078.          ---------------------
  1079.          When set, FIND will display the drive, path, and file name
  1080.          of the first file that matches the input argument.
  1081.          The default drive and path will be set to that of the matched
  1082.          file, and the program will terminate.
  1083.           
  1084.           
  1085.           
  1086.          ----------------------
  1087.          /H - Hidden Files Only
  1088.          ----------------------
  1089.          When set, FIND will search all drive(s) and display only
  1090.          those files which have the SYSTEM or HIDDEN bits set in
  1091.          their directory entry.
  1092.           
  1093.          This search will pick up the DOS system files, and all
  1094.          volume labels.  Any other hidden files, such as those
  1095.          installed by copy protection programs will also be displayed.
  1096.           
  1097.          Subdirectories marked as hidden are not displayed.
  1098.           
  1099.           
  1100.           
  1101.          -----------------------
  1102.          /L - List Scroll Buffer
  1103.          -----------------------
  1104.          When set, FIND will keep an internal scroll buffer capable
  1105.          of displaying the first 64k of output.  When FIND has
  1106.          completed it search, the user may use the cursor keys to
  1107.          scroll up and down in the buffer.
  1108.           
  1109.          The scroll buffer can display at least 819 lines of output
  1110.          without having to redirect the output to a disk file.
  1111.          Larger requirements dictate the use of a disk redirection
  1112.          file.  Screen output is turned off when /L is active.
  1113.           
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                                     Page 17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.          COMMAND LINE SWITCHES
  1130.           
  1131.           
  1132.          Switches are available in the Registered version.
  1133.           
  1134.          --------------------------
  1135.          /P - Pause for Full Screen
  1136.          --------------------------
  1137.          When set, FIND will pause when the screen is full and prompt
  1138.          the user to hit any key to continue.  The top screen banner
  1139.          will scroll off leaving all of the following screens at full
  1140.          length for output display.  Each subsequent screen will also
  1141.          pause when full.
  1142.           
  1143.          The /L option will disable the pause switch.
  1144.           
  1145.           
  1146.           
  1147.          ------------------------
  1148.          /S - Single drive search
  1149.          ------------------------
  1150.          When set, FIND will only search a single drive.
  1151.          If no drive letter is given with the command line argument
  1152.          the default drive is searched.
  1153.           
  1154.          A drive letter given in the command line will cause FIND to
  1155.          begin the search at that drive, and stop when the specified
  1156.          drive is complete.
  1157.           
  1158.           
  1159.           
  1160.          -------------------------
  1161.          /V - Verbose path display
  1162.          -------------------------
  1163.          When set, FIND will display all subdirectories searched.
  1164.          This is useful for building a list of all subdirectories
  1165.          on all drive(s) searched.
  1166.           
  1167.          This switch is also used if FIND is suspected of not finding
  1168.          a subdirectory.  Junk is an indicator of a bug in FIND or
  1169.          other disorder such as a cross-linked subdirectory.
  1170.           
  1171.           
  1172.           
  1173.          --------------------
  1174.          /Z - ZIP file search
  1175.          --------------------
  1176.          When set, FIND will open and search all ZIP files.
  1177.          Any ZIP member that matches the input argument will be
  1178.          displayed.  The ZIP file holding that member will be
  1179.          displayed in Inverse video, as a subdirectory would be.
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                     Page 18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.          IMPLEMENTATION
  1196.           
  1197.           
  1198.          --------------
  1199.          Technical Data
  1200.          --------------
  1201.          Screen performance has been improved by utilizing direct
  1202.          screen writes.  Snow prevention is implemented only when
  1203.          the CGA card is detected.
  1204.           
  1205.          FIND uses the BIOS Int 11h installed equipment call to check
  1206.          the number of installed floppy disk drives.  If
  1207.          a switch is set wrong, and this value is corrupted then
  1208.          FIND will encounter errors trying to access the non-
  1209.          installed drive.  Any floppy error causes that floppy to
  1210.          be bypassed.
  1211.           
  1212.          If the BIOS is set to 4 floppy drives (0..3), FIND will
  1213.          assume the first hard drive to be device #4.  If the
  1214.          system actually has only 2 floppies and a hard disk, FIND
  1215.          will exit with no files found, because it starts
  1216.          searching at drive #4 which does not exist.  Check your
  1217.          switch settings.
  1218.           
  1219.          FIND uses the DOS direct read interrupt Int25h.  The new
  1220.          DOS 4 version deviates from earlier versions in the manner
  1221.          that this interrupt is implemented.  FIND automatically
  1222.          uses the extended partition calling convention for DOS 4
  1223.          and up.
  1224.           
  1225.          FIND takes over one interrupt vector, Int23h (Control Break).
  1226.          The control break allows the user to quit FIND at any
  1227.          point during the execution.
  1228.           
  1229.          The vector is restored upon any exit from the program.
  1230.           
  1231.          A user entered ^C causes the program to terminate and
  1232.          restore the ^C vector at exit.
  1233.           
  1234.          FIND performs direct reads of the disk and can not damage the
  1235.          integrity of the disk.  No writes are done to the disk.
  1236.           
  1237.          There exists a naming conflict with a DOS program of the same
  1238.          name.  FIND can be renamed to something else if the DOS
  1239.          program is regularly used.  FIND can also be placed in a
  1240.          path that comes before the DOS path.
  1241.           
  1242.          FIND is written entirely in Turbo Assembler v2.01.
  1243.           
  1244.           
  1245.           
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.                                     Page 19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.          IMPLEMENTATION
  1262.           
  1263.           
  1264.          ---
  1265.          PIF
  1266.          ---
  1267.          FIND is 'ill behaved' in screen management functions
  1268.          as direct screen writes are used.
  1269.           
  1270.          FIND is 'ill behaved' for vectors as it takes over 23h,
  1271.          the Control-Break vector.
  1272.           
  1273.           
  1274.           
  1275.          --------------
  1276.          DOS ERRORLEVEL
  1277.          --------------
  1278.          0 - No errors
  1279.          1 - Parsing error
  1280.          2 - BIOS Load_Boot error
  1281.          3 - DOS read error
  1282.          4 - DOS write error
  1283.          5 - User ^C
  1284.           
  1285.           
  1286.           
  1287.          _________________
  1288.          CGA SNOW CHECKING
  1289.          -----------------
  1290.          CGA snow checking will be implemented when a successful
  1291.          test of the retrace hardware has been completed.
  1292.           
  1293.          Some oddball mono-graphics cards do not correctly support the
  1294.          horizontal retrace bit in CGA status port 3DAh.  The result
  1295.          is FIND hanging forever waiting for the bit to change state.
  1296.           
  1297.          The test first waits for the retrace bit to become clear,
  1298.          then waits for it to set again.  If either test fails, then
  1299.          the retrace hardware is assumed defective and snow checking
  1300.          is disabled.
  1301.           
  1302.          Non-standard use of this port can cause unpredictable
  1303.          results.  If this is suspected, the user may enable or
  1304.          disable CGA snow checking from the SET SWITCHES panel of
  1305.          FINDINST.  This will override the startup tests and force the
  1306.          CGA snow testing into the mode selected by the user.
  1307.           
  1308.          The suggested method is to set CGA snow checking to OFF which
  1309.          will bypass any potential hang condition.  If no screen snow
  1310.          is encountered, leave the switch off.  Performance is
  1311.          significantly improved with snow checking turned off.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                     Page 20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.          IMPLEMENTATION
  1328.           
  1329.           
  1330.          --------------
  1331.          Error Messages
  1332.          --------------
  1333.          'Unable to locate or read header for..'
  1334.               o  The ZIP file is damaged or corrupted.
  1335.           
  1336.           
  1337.           
  1338.          'Logic error locating central directory for '
  1339.               o  Internal error in FIND
  1340.           
  1341.           
  1342.           
  1343.          'Insufficient memory to search this subdirectory'
  1344.               o  A subdirectory greater than 64k is being searched
  1345.                  and not enough memory is available to load it.
  1346.           
  1347.               o  /L switch has requested a scroll buffer and no EMS
  1348.                  memory is available.  Scroll buffer removes 64k of
  1349.                  DOS memory that is available for directory loads.
  1350.           
  1351.               o  FIND is trying to run in 384k or less.
  1352.           
  1353.               o  FIND is running from another program which has
  1354.                  SHELL'd out to DOS
  1355.           
  1356.           
  1357.           
  1358.          'Insufficient memory to search xxx.ZIP'
  1359.               o  Not enough free memory available to load the ZIP
  1360.                  file central directory for searching.
  1361.           
  1362.           
  1363.           
  1364.          'Invalid boot sector for drive x:'
  1365.               o  Non-standard DOS boot sector was detected.
  1366.                  Bytes per sector is zero or not contined in the
  1367.                  set of 64,128,256,512,1024,2048,4096,8192.
  1368.           
  1369.               o  Boot sector has returned Zero bytes per sector
  1370.                  Specialized RAM disks such as some AST products
  1371.                  do not utilize a standard DOS boot sector.
  1372.           
  1373.           
  1374.           
  1375.           
  1376.           
  1377.           
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.                                     Page 21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.          IMPLEMENTATION
  1394.           
  1395.           
  1396.          -----
  1397.          Usage
  1398.          -----
  1399.           
  1400.          Valid switches are:  /G  /H  /L  /P  /S  /V  /Z
  1401.           
  1402.                   /G - Goto Match
  1403.                        The default drive and directory are changed to
  1404.                        that of the first matching file.
  1405.           
  1406.                   /H - Hidden file(s)
  1407.                        Only file attributes that match either the
  1408.                        system or hidden bits will be displayed.
  1409.                        This switch disables the /Z switch.
  1410.           
  1411.                   /L - List scroll buffer
  1412.                        The first 819 lines of output are saved in a
  1413.                        scrollable buffer.
  1414.                        This switch disables the /P switch.
  1415.           
  1416.                   /P - Pause mode
  1417.                        The program will pause when the screen is full.
  1418.           
  1419.                   /S - Single drive
  1420.                        Only a single drive will be searched.
  1421.                        If not specified, the default drive is assumed.
  1422.                        Otherwise, the first file specified by the user
  1423.                        is the only drive searched.
  1424.           
  1425.                   /V - Verbose path display
  1426.                        Every path searched will be displayed.
  1427.                        Useful to build a complete path table of the
  1428.                        specified drive(s) by searching for a non-
  1429.                        existent file.
  1430.           
  1431.                   /Z - search zip files
  1432.                        All PKZIP files will be searched for member(s)
  1433.                        matching the input argument.
  1434.                        Corrupted ZIP files will be identified with an
  1435.                        error message.  Empty ZIP files are not
  1436.                        reported.
  1437.           
  1438.           
  1439.           
  1440.           
  1441.           
  1442.           
  1443.           
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                     Page 22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.          IMPLEMENTATION
  1460.           
  1461.           
  1462.          ---------------------
  1463.          Command Line Examples
  1464.          ---------------------
  1465.           
  1466.              FIND file
  1467.                   Start with the default hard drive.
  1468.                   No dot defaults to all file extensions.
  1469.                   Match all occurrences of 'file????.???'
  1470.           
  1471.           
  1472.              FIND file.
  1473.                   Start with the default hard drive.
  1474.                   The dot specifies no file extension.
  1475.                   Confine match to 'file'.
  1476.           
  1477.           
  1478.              FIND *
  1479.                   Start with the default hard drive.
  1480.                   Find all files.
  1481.           
  1482.           
  1483.              FIND *.*
  1484.                   Start with the default hard drive.
  1485.                   Find all files.
  1486.           
  1487.           
  1488.              FIND *.* /H
  1489.                   Start with the default hard drive.
  1490.                   Find hidden files only.
  1491.           
  1492.           
  1493.              FIND *.* /V
  1494.                   Start with the default hard drive.
  1495.                   Display all paths as they are scanned.
  1496.           
  1497.           
  1498.              FIND *.* /H /S
  1499.                   Start with the default drive.
  1500.                   Find hidden files only.
  1501.                   Check only the default drive.
  1502.           
  1503.           
  1504.              FIND A:*.*
  1505.                   Start with the A: drive.
  1506.                   Find all files.
  1507.           
  1508.           
  1509.           
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                     Page 23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.          IMPLEMENTATION
  1526.           
  1527.           
  1528.          ---------------------
  1529.          Command Line Examples
  1530.          ---------------------
  1531.           
  1532.              FIND G:*.* /S
  1533.                   Start with the G: drive.
  1534.                   Find all files.
  1535.                   Check only the G: drive.
  1536.           
  1537.           
  1538.              FIND *.* /H /S > PRN
  1539.                   Start with the default hard drive.
  1540.                   Find hidden files only.
  1541.                   Check only the first hard drive.
  1542.                   Redirect output to printer.
  1543.           
  1544.           
  1545.              FIND *.* /H /S > C:\Temp\Dir.Lst
  1546.                   Start with the default hard drive.
  1547.                   Find hidden files only.
  1548.                   Check only the first hard drive.
  1549.                   Redirect output to disk file on drive C:
  1550.           
  1551.           
  1552.              FIND *IBM*
  1553.                   Find any occurrence of the letters 'IBM' in
  1554.                   the file name field.  The file extent field
  1555.                   defaults to .???
  1556.           
  1557.           
  1558.              FIND *IB??IO*
  1559.                   Find any occurrence of the letters 'IB??IO' in
  1560.                   the file name field.  The file extent field
  1561.                   defaults to '.???'.
  1562.                   This example would find IBMBIO.COM.
  1563.           
  1564.           
  1565.              FIND *.*A*
  1566.                   Find any occurrence of the letter 'A' in the
  1567.                   the file extension field.  The letter can be
  1568.                   in position 1,2, or 3.   The file name field
  1569.                   defaults to '????????'.
  1570.           
  1571.           
  1572.              FIND E:Command.Com  /G
  1573.                   Find COMMAND.COM starting with the E: drive and
  1574.                   change to the drive:directory where it was found.
  1575.           
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                     Page 24
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.          SUPPORT
  1592.           
  1593.           
  1594.          -----------
  1595.          BUG Reports
  1596.          -----------
  1597.          Bug reports are welcomed.
  1598.           
  1599.          1)  Make/Version of DOS
  1600.          2)  Copy of AUTOEXEC.BAT and CONFIG.SYS
  1601.          3)  Names of TSRs if any, that are loaded
  1602.          4)  Redirected copy of FIND in verbose mode.
  1603.              e.g.  FIND <nonexistent.file> /V > DUMP.FIL
  1604.              This provides a list of all subdirectories.
  1605.          5)  Use SNAPSHOT to take a dump of the suspect disk.
  1606.          6)  Run CHKDSK against the failing drive.
  1607.           
  1608.          Attempt to diagnose any bugs by unloading all TSRs and
  1609.          start with as simple a system as possible.
  1610.           
  1611.           
  1612.           
  1613.          ------------
  1614.          Registration
  1615.          ------------
  1616.          Please fill out the enclosed ORDER.FRM.
  1617.           
  1618.          Bruce Gavin
  1619.          CompuServe: 70137,3244
  1620.          GEnie     : B.GAVIN
  1621.           
  1622.           
  1623.           
  1624.          ----------
  1625.          BBS System
  1626.          ----------
  1627.          Online Reference BBS:
  1628.          (719) 380-9095 (voice)
  1629.          (719) 591-0302 24 hours,
  1630.          (9600 is under testing now)
  1631.           
  1632.          Programmers Online Reference Guides
  1633.          Norton Guide databases
  1634.          Home of ALTER, ET, FRESHEN, and other fine utilities.
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                                     Page 25
  1648.  
  1649.  
  1650.  
  1651.